Welcome to the AppleScript™ Extension for QuicKeys™ Read Me file.
WARNING: THE ACCOMPANYING EXTENSION IS A PRERELEASE ADDITION FOR CE SOFTWARE'S QUICKEYS UTILITY. THIS EXTENSION MAY OR MAY NOT BE INCLUDED IN FUTURE VERSIONS OF QUICKEYS. THIS COPY IS PROVIDED ONLY FOR LICENSED USERS OF THIS CD-ROM AND MAY NOT BE REDISTRIBUTED.
CE SOFTWARE'S TECHNICAL SUPPORT LINES CANNOT PROVIDE SUPPORT ON THIS PRERELEASE UTILITY. YOU MAY SEND FEEDBACK TO THE APPLELINK ADDRESS OF "DON.BROWN"; HOWEVER, NO RESPONSES OR FIXES ARE PROMISED (but I'll try). USE OF THIS EXTENSION IS AT YOUR OWN RISK.
Requirements:
QuicKeys™ version 2.1 or later
CEIAC 2.00as or later (included with this extension)
AppleScript™ a10 or later
AppleScript is Apple's exciting new scripting language for controlling Apple® Event aware programs. Executing scripts from QuicKeys means that scripts can be executed with a keystroke, from a QuicKeys menu, on a timed basis, or merged with other QuicKeys' capabilities.
To install, put the AppleScript.QK extension in the Extensions folder in the QuicKeys folder in the Preferences folder in your System folder (or use QuicKeys' Extension Manager to install it). You also need to install the new CEIAC by dragging the new icon into the System folder. You may need to drag the old CEIAC out because your system may not be able to replace it automatically if CEIAC is still running in the background. Reboot.
To create the keys, open the QuicKeys editor and select AppleScript from the Extensions submenu from the Define menu. A dialog box appears.
The script can be tied to the key in two ways:
(1) If the script is 2000 characters or less, you can click the Modify text button and paste the script into the editor window. (This editor window has no scrolling bar and no ability to check the syntax, so we recommend you write the script in Toy Surprise and copy and paste it into QuicKeys).
(2) If your script is longer than 2000 characters, you may save the script into a file on some volume and point the extension to that file. QuicKeys will open the file, read the script and run the script at execution time.
Once the script is entered, it can be triggered by a keystroke, a timer, from a QuicKeys menu, a SoftKey palette, a QK Icon or any other method of executing QuicKeys.
Note: The application the key works with must be running when the script is executed.
If your script returns a result, QuicKeys can act upon that result by doing one of the following:
(1) Ignoring it. (Nothing happens.)
(2) Typing it. (QuicKeys will convert the result to text and then generate keydown events for the result (up to 255 characters).)
(3) Displaying it. (QuicKeys will convert the result to text and then display the result in a notification manager dialog (up to 255 characters).)
(4) Putting it on the Clipboard. (QuicKeys will get the result in its native form and put it on the Clipboard. It cannot do a complete Clipboard coercion, so some programs (such as Microsoft Word) may not be able to access this Clipboard. In that case, put the key in a sequence that brings the Finder to the front, executes the key and then brings Microsoft Word to the front.)
There will be an option where, before the key is executed, the contents of the Clipboard will be converted to text and stored in an AppleScript variable called QKClipboard which will let your script modify or respond to the Clipboard. This feature is not implemented as of yet.
QuicKeys, QuicKeys 2, TAA, Technical Assistance Assistant, Tiles, CEToolbox, DialogKeys, QuickMail, DiskTop, Extension Manager, Heap Fixer, Type Ease, Paste Ease, Grab Ease, Screen Ease, Speak Ease, Mounty, Choosy, DisMounty, and CEIAC are trademarks of CE Software, Inc. All other trademarks are the property of their respective holders.
